Caractéristiques communes

Les caractéristiques énoncées ci-dessous sont communes aux commandes uniexp, uniimp et aux commandes sur les packages.

Ces commandes se connectent à UVMS pour récupérer les informations d'authentification; puis elles se connectent ensuite directement au nœud cible pour extraire des informations (comme UVC pourrait le faire).

• Si plusieurs filtres adressent le même type d'objet, tous les filtres sont combinés pour extraire / importer les objets (ET logique).

  Par exemple une commande uniexp contenant les paramètres -jeses="SES*" -jemu="*MU*" extrait tous les événements jobs dont la session commence par "SES" et dont l'UG contient "MU".

• Si le même filtre est utilisé plusieurs fois avec des valeurs différentes, seule la première valeur sera prise en compte.

  Par exemple : -upr "A*" -upr "B*", seules les Uprocs commençant par A seront extraites / importées.

• Le caractère * peut être utilisé en début ou en fin de chaîne.

  Par exemple : "TEST*" signifie "commençant par TEST", "*TEST" signifie "se terminant par TEST", "*TEST*" signifie "contenant TEST".

Variables d'environnement

Deux variables d'environnement permettent d'ajuster la mémoire utilisée par les commandes d'import-export. 

• UXMINJVMMEM (Taille mémoire initiale de la zone heap) vaut par défaut 128 Mo
• UXMAXJVMMEM (Taille mémoire maximum de la zone heap) vaut par défaut 1024Mo

L'utilisateur peut changer ces valeurs avant de lancer les commandes d'export, import ou mise à jour en utilisant les commandes système :

• Sous Unix :

  UXMINJVMMEM=256

  export UXMINJVMMEM

  UXMAXJVMMEM=2048

  export UXMAXJVMMEM

• Sous Windows :

  set UXMINJVMMEM=256

  set UXMAXJVMMEM=2048

Code retour

La commande retourne :

• 0 si elle s'est exécutée sans erreur.
• 1 si elle s'est exécutée avec des erreurs. Les erreurs sont listées dans la sortie de la commande.
• 2 si elle s'est exécutée sans erreur, mais aucun objet correspondant au filtre n’a été trouvé.

Dans le cas où le résultat de la commande est long, il est recommandé de rediriger la sortie standard et la sortie erreur dans un fichier. Par exemple :

./uniexp [param=valeur] > ./export.log 2>&1"